home *** CD-ROM | disk | FTP | other *** search
/ Aminet 21 / Aminet 21 (1997)(GTI - Schatztruhe)[!][Oct 1997].iso / Aminet / docs / misc / ahiman.readme < prev    next >
Encoding:
Text File  |  1997-09-05  |  8.3 KB  |  209 lines
  1. Short:    Retargetable audio v4.14, Doc. Archive
  2. Author:   Martin Blom <lcs@lysator.liu.se>
  3. Uploader: Martin Blom <lcs@lysator.liu.se>
  4. Type:     docs/misc
  5.  
  6.      This archive contains the documentation for AHI (both
  7.      AHI Developer's Guide and AHI User's Guide) as DVI,
  8.      Postscript and HTML files.
  9.  
  10.      AmigaGuide® versions are included in the AHI Developer's
  11.      archive and the AHI User's archive.
  12.  
  13.      Changes since last release
  14.      ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  15.      Bug fixes.
  16.      The Paula driver can now be told to swap left and right channel.
  17.      Toccata driver updated, should work fine on Draco Motion again.
  18.      Added Melody to the distribution.
  19.  
  20.  
  21.  
  22. TITLE
  23.  
  24.      AHI Audio system
  25.  
  26. VERSION
  27.  
  28.      Release 4
  29.  
  30. AUTHOR
  31.  
  32.      Martin Blom <lcs@lysator.liu.se>
  33.  
  34. DESCRIPTION
  35.  
  36.      Retargetable Audio for AmigaOS
  37.      ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  38.  
  39.      (When refering to this software, the correct term is
  40.      'AHI audio system' or just 'AHI', never 'Audio Hardware
  41.      Interface'! 'AHI' is pronounced 'atchii', as in 'God bless!'.)
  42.  
  43.      Starting with version 3 of AHI, the MC68000 processor is also supported.
  44.      However, many features are lacking:
  45.  
  46.      · Very limited volime control when using 16 bit samples
  47.      · No HiFi mixing routines are available.
  48.      · No stereo samples
  49.      · No DSP effects are available.
  50.      · Less precision on some calculations
  51.      · Slower
  52.  
  53.      As you can see, this version is very primitive.  Get yourself an
  54.      accelerator!  I cannot guarantee that I will continue to support this
  55.      processor in the future.
  56.  
  57.      Quick overview
  58.      ¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  59.  
  60.      * Driver based
  61.  
  62.      Each supported sound card is controlled by a library-based audio
  63.      driver. For a 'dumb' sound card, a new driver should be written in
  64.      a few hours. For a 'smart' sound card, it is possible to utilize an
  65.      on-board DSP, for example, to maximize performance and sound quality.
  66.      For sound cards with own DSP but little or no memory, it is possible
  67.      to use the main CPU to mix channels and do the post-processing
  68.      with the DSP. Available today are drivers for
  69.  
  70.      · Aura (sampler only)
  71.      · Delfina DSP and Delfina Lite
  72.      · DraCo Motion
  73.      · Paula (8/14/14c bit)
  74.      · Prelude
  75.      · Toccata
  76.      · Wavetools
  77.      · 8SVX (mono) and AIFF/AIFC (mono & stereo) sample render
  78.  
  79.      * Fast, powerful mixing routines (yeah, right... haha)
  80.  
  81.      The device's mixing routines mix 8- or 16-bit signed samples, both
  82.      mono and stereo, located in Fast-RAM and outputs 16-bit mono or stereo
  83.      (with stereo panning if desired) data, using any number of channels
  84.      (as long as 'any' means less than 128...).  Tables can be used speed
  85.      the mixing up (especially when using 8-bit samples).  The samples can
  86.      have any length (including odd) and can have any number of loops.
  87.      
  88.      * Support for non-realtime mixing
  89.  
  90.      By providing a timing feature, it is possible to create high-
  91.      quality output even if the processing power is lacking, by saving
  92.      the output to disk, for example as an IFF AIFF or 8SXV file.
  93.      There are so-called HiFi mixing routines that can be used, which
  94.      use linear interpolation and gives 32 bit output.
  95.  
  96.      * Audio database
  97.  
  98.      Uses ID codes, much like Screenmode IDs, to select the many
  99.      parameters that can be set. The functions to access the audio
  100.      database are not too different from those in 'graphics.library'.
  101.      The device also features a requester to get an ID code from the
  102.      user.
  103.  
  104.      * Both high- and low-level protocol
  105.  
  106.      By acting both like a device and a library, AHI gives the programmer
  107.      a choice between full control and simplicity. The device API allows
  108.      several programs to use the audio hardware at the same time, and
  109.      the AUDIO: dos-device driver makes playing and recording sound very
  110.      simple for both the programmer and user.
  111.  
  112.      * Future Compatible
  113.  
  114.      When AmigaOS gets device-independent audio worth it's name, it should
  115.      not be too difficult to write a driver for AHI, allowing applications
  116.      using 'ahi.device' to automatically use the new OS interface. At
  117.      least I hope it wont.
  118.  
  119. SPECIAL REQUIREMENTS
  120.  
  121.      AmigaOS release 2.
  122.      MC68020 processor strongly recommended.
  123.  
  124. AVAILABILITY
  125.  
  126.      Aminet, for example:
  127.      ftp://ftp.germany.aminet.org/pub/aminet/dev/misc/ahidev.lha
  128.      ftp://ftp.germany.aminet.org/pub/aminet/mus/misc/ahiusr.lha
  129.      ftp://ftp.germany.aminet.org/pub/aminet/docs/misc/ahiman.lha
  130.  
  131.      WWW:
  132.      http://www.lysator.liu.se/~lcs/ahi.html
  133.  
  134. PRICE
  135.  
  136.      Free. But if you use it in a shareware of commercial product,
  137.      I would like a registered copy for me and each of the audio driver
  138.      authors (this is merely a wish, you don't have to do it if you don't
  139.      think we deserve it). See the AHI User's Guide for more information.
  140.  
  141. DISTRIBUTABILITY
  142.  
  143.      Copyright ©1994-1997 Martin Blom.
  144.      Freely distributable in unmodified form.
  145.      See the AHI User's Guide for more information.
  146.  
  147.  
  148. ============================= Archive contents =============================
  149.  
  150. Original  Packed Ratio    Date     Time    Name
  151. -------- ------- ----- --------- --------  -------------
  152.     5009    2326 53.5% 19-Aug-97 18:34:56 +ahiman.readme
  153.    93088   22757 75.5% 19-Aug-97 17:55:40 +ahidev.dvi
  154.    80260   22358 72.1% 19-Aug-97 17:55:40 +ahiusr.dvi
  155.     3554    1382 61.1% 19-Aug-97 17:55:44 +ahidev_1.html
  156.     7228    2699 62.6% 19-Aug-97 17:55:42 +ahidev_10.html
  157.     1867     835 55.2% 19-Aug-97 17:55:42 +ahidev_11.html
  158.     2885    1147 60.2% 19-Aug-97 17:55:42 +ahidev_12.html
  159.     2929    1100 62.4% 19-Aug-97 17:55:42 +ahidev_13.html
  160.     5431    2073 61.8% 19-Aug-97 17:55:42 +ahidev_14.html
  161.     1111     468 57.8% 19-Aug-97 17:55:42 +ahidev_15.html
  162.     1813     730 59.7% 19-Aug-97 17:55:42 +ahidev_16.html
  163.     1864     828 55.5% 19-Aug-97 17:55:42 +ahidev_17.html
  164.     3656     989 72.9% 19-Aug-97 17:55:42 +ahidev_18.html
  165.     1223     460 62.3% 19-Aug-97 17:55:42 +ahidev_19.html
  166.     2568    1194 53.5% 19-Aug-97 17:55:44 +ahidev_2.html
  167.     1429     480 66.4% 19-Aug-97 17:55:42 +ahidev_20.html
  168.     2755     725 73.6% 19-Aug-97 17:55:42 +ahidev_21.html
  169.     1166     532 54.3% 19-Aug-97 17:55:44 +ahidev_3.html
  170.     1728     765 55.7% 19-Aug-97 17:55:44 +ahidev_4.html
  171.     1819     768 57.7% 19-Aug-97 17:55:42 +ahidev_5.html
  172.     3119    1227 60.6% 19-Aug-97 17:55:42 +ahidev_6.html
  173.     2730    1079 60.4% 19-Aug-97 17:55:42 +ahidev_7.html
  174.     6139    2170 64.6% 19-Aug-97 17:55:42 +ahidev_8.html
  175.     3486    1496 57.0% 19-Aug-97 17:55:42 +ahidev_9.html
  176.      776     460 40.7% 19-Aug-97 17:55:44 +ahidev_foot.html
  177.     3753    1170 68.8% 19-Aug-97 17:55:44 +ahidev_toc.html
  178.     3605    1626 54.8% 19-Aug-97 17:55:46 +ahiusr_1.html
  179.     1158     528 54.4% 19-Aug-97 17:55:46 +ahiusr_10.html
  180.     1143     478 58.1% 19-Aug-97 17:55:44 +ahiusr_11.html
  181.      936     395 57.7% 19-Aug-97 17:55:44 +ahiusr_12.html
  182.     1992     881 55.7% 19-Aug-97 17:55:44 +ahiusr_13.html
  183.     2711    1250 53.8% 19-Aug-97 17:55:44 +ahiusr_14.html
  184.     4644    1842 60.3% 19-Aug-97 17:55:44 +ahiusr_15.html
  185.     1644     644 60.8% 19-Aug-97 17:55:44 +ahiusr_16.html
  186.     5603    2257 59.7% 19-Aug-97 17:55:44 +ahiusr_17.html
  187.     3636    1451 60.0% 19-Aug-97 17:55:44 +ahiusr_18.html
  188.     1398     599 57.1% 19-Aug-97 17:55:44 +ahiusr_19.html
  189.     2624    1204 54.1% 19-Aug-97 17:55:46 +ahiusr_2.html
  190.     2265    1096 51.6% 19-Aug-97 17:55:44 +ahiusr_20.html
  191.     1414     621 56.0% 19-Aug-97 17:55:44 +ahiusr_21.html
  192.     2143     997 53.4% 19-Aug-97 17:55:44 +ahiusr_22.html
  193.     2237    1157 48.2% 19-Aug-97 17:55:44 +ahiusr_23.html
  194.     1658     681 58.9% 19-Aug-97 17:55:44 +ahiusr_24.html
  195.     6180    1509 75.5% 19-Aug-97 17:55:44 +ahiusr_25.html
  196.     1295     621 52.0% 19-Aug-97 17:55:46 +ahiusr_3.html
  197.     1133     460 59.3% 19-Aug-97 17:55:46 +ahiusr_4.html
  198.     2327    1053 54.7% 19-Aug-97 17:55:46 +ahiusr_5.html
  199.     2562    1074 58.0% 19-Aug-97 17:55:46 +ahiusr_6.html
  200.      997     380 61.8% 19-Aug-97 17:55:46 +ahiusr_7.html
  201.     1440     641 55.4% 19-Aug-97 17:55:46 +ahiusr_8.html
  202.     1186     485 59.1% 19-Aug-97 17:55:46 +ahiusr_9.html
  203.     2477    1224 50.5% 19-Aug-97 17:55:46 +ahiusr_foot.html
  204.     2286     801 64.9% 19-Aug-97 17:55:46 +ahiusr_toc.html
  205.   215735   82046 61.9% 19-Aug-97 17:55:40 +ahidev.ps
  206.   192279   74648 61.1% 19-Aug-97 17:55:42 +ahiusr.ps
  207. -------- ------- ----- --------- --------
  208.   714094  254867 64.3% 19-Aug-97 21:00:08   55 files
  209.